GENEVE MDOS 6.50 COMPILATION NOTES

March 28, 2001 - Tim Tesch
Updated July 13, 2003 by Tony Knerr

--------------------------------------------------------------------

DESCRIPTION:
MDOS must be compiled with GenASM, GenLINK, GenMAKE which are all
part of Paul Charleton's GenProg package. These programs are native
MDOS programs; therefore, MDOS must be compiled on a Geneve using a
previously compiled version of MDOS.

PROCEDURE:
To compile MDOS, you must have all of the source files in the proper
directory structure starting at the ROOT of the hard drive. The 
subdirectories correspond to the MDOS archive filenames.  Files that
belong at the root (MDOS) level are in the ROOT archive.  You must
also have the GenProg utility.

--------------------------------------------------------------------

The following directories on your hard drive must be created,
where "x" is the letter assigned to the hard drive containing the
MDOS source code: 


x:\MDOS\
x:\MDOS\CLI\
x:\MDOS\HD\
x:\MDOS\HDOS\
x:\MDOS\HEAD\
x:\MDOS\IDEAS\
x:\MDOS\L10\
x:\MDOS\L6\
x:\MDOS\L7\
x:\MDOS\L8\
x:\MDOS\L9\
x:\MDOS\LN\
x:\MDOS\SCSI\
x:\MDOS\SCSI2\


Unpack the archived files in the distribution ZIP to the 
directory of the same name by doing the following:

- The .ark files are TI-archived files with a TIFILES header.
  So you need to transfer them to the Geneve with an XMODEM 
  program and serial cable, or with PCTransfer, or something
  equivalent.
- Unpack the transferred files onto floppies, then copy the
  floppies to the appropriate directories on the hard drive.
  It helps to have 2880 sector disks for this as some of the
  archives unpack to more than 1440 sectors, else some archives
  will need to be split up onto separate floppies when
  unpacking.

(There may be other ways to do this, but the above procedure
is known to work,)


--------------------------------------------------------------------

Since the MAKE program is flawed and uses a two-digit year, it
becomes more difficult to track changes and assemble the code.  

Therefore, it is suggested to set the date on your Geneve to
06-07-99 when compiling MDOS, which will also put the data CYA
uses in all the same offsets as the distributed version of MDOS
(v6.50). 

--------------------------------------------------------------------

Make sure the prompt is in the \MDOS directory by typing:

CD MDOS <enter>    

at the root level prompt of the Hard Drive containing your MDOS
source code.

Then use the following command to begin a FULL compilation:

MAKE HDOS,F <enter>

This tells MAKE to use the !MAKEFILE dependency file to generate
object code.  The ",F" flag tells MAKE to FORCE a full compilation,
meaning every source file will be assembled and the appropriate
object files created in their respective directories.  HDOS is the
"rule" by which MAKE does its work.  See "!MAKEFILE" for some
details.

Finally, after the object code is generated, MAKE will launch LINK.
LINK takes all of the object code, places it into the correct banks
of memroy, links/resolves the labels/addresses, and creates the
final product: HDOS.

The TESTH executable can be used to test mdos from the MDOS folder
as follows:

TESTH  HDOS\HDOS <enter>

If all goes well, your new MDOS will load and run.

--------------------------------------------------------------------

DISTRIBUTION NOTES:

Once the new MDOS is tested, the final step is to imbed the CRC
values. The program in question loads MDOS, calculates CRC values,
does some additional "massaging", then imbeds the codes.   I have
a copy of this program, as does one, perhaps two other people.
I have asked these people to not distribute the code or the program
without consulting me first.

Tim

'& Tony'